.....
.....

int main ( void )
{
    
   SYS_Initialize ( NULL ); //システム初期化

    while ( true )
    {
        SYS_Tasks ( );      //繰り返し実行
    } 
    return ( EXIT_FAILURE );
}

.....
.....

void SYS_Tasks ( void )
{
....
....

    APP_Tasks();
}

.....
.....


#include "app.h"

DRV_HANDLE  myHandle;
bool LED;

void tmrISR(uintptr_t context, uint32_t alarmCount ) //タイマコールバック関数
{    
    if(LED == false)
    {
        LED = true;
        PLIB_PORTS_PinSet( PORTS_ID_0, PORT_CHANNEL_G, 15 );    //RG15：　LED点灯
        //LATGbits.LATG15 = 1;
        PLIB_TMR_Period16BitSet(TMR_ID_1,39063); 
                            //ISR内でないと周期レジスタの値は変えられない
                                //5 nsec x20 x 39063 x 256 = 1000.0128msec = 1sec 
    }
    else
    {
        LED = false; 
        PLIB_PORTS_PinClear( PORTS_ID_0, PORT_CHANNEL_G, 15 );  //RG15：　LED消灯                
        //LATGbits.LATG15 = 0;
        PLIB_TMR_Period16BitSet(TMR_ID_1,39063);   //5sec  消灯 //x100
    } 
    
};

....
....

void APP_Initialize ( void )
{
  
    appData.state = APP_STATE_INIT;

    myHandle = DRV_TMR_Open ( DRV_TMR_INDEX_0, DRV_IO_INTENT_EXCLUSIVE );　//
                                         //タイマドライバーハンドル取得
    
    uint32_t divider = 39063;//周期レジスタ初期値//最初の割り込みまでの時間をセット
           //5 nsec x20 x 39063 x 256 = 1000.0128msec = 1sec  at Fblclk3 = 10MHz
    
    DRV_TMR_AlarmRegister ( myHandle, divider, true, 0, tmrISR );  //
                    //コールバック関数tmrISR( )の繰り返し呼び出しをセットアップ
    
    DRV_TMR_Start(myHandle);    //タイマ1割り込み許可、タイマ1イネーブル 
}

void APP_Tasks ( void )
{
    switch ( appData.state )
    { 
        case APP_STATE_INIT:
        {
            break;
        }
        case APP_STATE_SERVICE_TASKS:
        {
            break;
        }
        default:
        {
            break;
        }
    }
}
  

....
....

const DRV_TMR_INIT drvTmr0InitData = //タイマの諸元のインスタンス生成と初期化
{
    .moduleInit.sys.powerState = DRV_TMR_POWER_STATE_IDX0,
    .tmrId = DRV_TMR_PERIPHERAL_ID_IDX0,
    .clockSource = DRV_TMR_CLOCK_SOURCE_IDX0, 
    .prescale = DRV_TMR_PRESCALE_IDX0,
    .mode = DRV_TMR_OPERATION_MODE_16_BIT,
    .interruptSource = DRV_TMR_INTERRUPT_SOURCE_IDX0,
    .asyncWriteEnable = false,
};

SYSTEM_OBJECTS sysObj;
....
....

void SYS_Initialize ( void* data )
{
....
....
    SYS_DEVCON_SystemUnlock();      //システム　アンロック
    PB3DIVbits.PBDIV = 0x13;  //19: PBCLK3 = 1/20(デフォルトの1/10) 
    SYS_DEVCON_SystemLock(); //システムロック
....
....   
      sysObj.  drvTmr0 =     //戻り値：タイマ用システムモジュールのハンドル  
      DRV_TMR_Initialize(DRV_TMR_INDEX_0, (SYS_MODULE_INIT *)&drvTmr0InitData);
　　　　　　　　　　　　　　　　//タイマ用システムモジュール初期化
....
....

    SYS_INT_Enable();

    APP_Initialize();
}

.....
.....
    
void __ISR(_TIMER_1_VECTOR, ipl1AUTO) IntHandlerDrvTmrInstance0(void)  //
{
    DRV_TMR_Tasks(sysObj.drvTmr0);　//
}

....
....
static unsigned int          gDrvTmrInstances = 0;  //現在の初期化済みインスタンス数 
....
....

typedef struct
{
    DRV_TMR_MODULE_INSTANCE         tmrInstance;     // the current timer module
    DRV_TMR_CLIENT_OBJ               tmrClients[1];   
               // Timer driver supports only Single Client. If you have multiple clients looking for timer, then use Timer System Service.
}DRV_TMR_MODULE_DESCRIPTOR;  //タイマモジュールデスクリプタ定義
....
....

SYS_MODULE_OBJ DRV_TMR_Initialize  //タイマ用システムモジュール初期化
( 
    const SYS_MODULE_INDEX drvIndex,
    const SYS_MODULE_INIT  * const init 
)
{
    
    DRV_TMR_MODULE_DESCRIPTOR* pTmrDcpt;//タイマ用システムモジュールの
                                        //デスクリプタのインスタンス生成
    DRV_TMR_MODULE_INSTANCE*   pTmrInst; //タイマ用システムモジュールの
                                         //インスタンス生成
    const DRV_TMR_INIT * tmrInit; //ダイナミックタイマの諸元（データ）
    
    
　　//ドライバーインデックスが規定の範囲内にあるかチェック
    if ( drvIndex >= DRV_TMR_INSTANCES_NUMBER )
    {
        return SYS_MODULE_OBJ_INVALID;
    }

    //既に初期化されたハードウェアインスタンスがないかチェック
    pTmrDcpt = gDrvTmrDcpt + drvIndex; 
    if ( pTmrDcpt->tmrInstance.inUse != false )
    {
        return (SYS_MODULE_OBJ)pTmrDcpt;
    }

   
    tmrInit = ( const DRV_TMR_INIT * ) init;//取得アドレスをローカル変数にコピー
    ....
    ....

   // Object is valid, set it in use
    pTmrInst = &pTmrDcpt->tmrInstance;
    pTmrInst->inUse = true;

    //タイマモジュールのインスタンス初期化
    pTmrInst->tmrId = tmrInit->tmrId;//タイマID（タイマ1)設定
    pTmrInst->clockSource = tmrInit->clockSource; //（内部）クロック源設定
    pTmrInst->prescale = tmrInit->prescale;  //プリスケーラ(1/256)設定
    pTmrInst->interruptSource = tmrInit->interruptSource;//割り込みベクトル(INT_T1)設定
    pTmrInst->operMode = tmrInit->mode;//(16bit)動作モード設定
    ....
    ....   
    pTmrInst->status = SYS_STATUS_READY; //準備完了

    gDrvTmrInstances++;

       return (SYS_MODULE_OBJ)pTmrDcpt; //戻り値：符号なし整数...
       //タイマドライバーのハンドル(sysObj.drvTmr0)を返す
       //ハンドル(符号なし整数)=(SYS_MODULE_OBJ)(デスクリプタのポインタ)と定義 at Harmony
       //typedef uintptr_t SYS_MODULE_OBJ;
       //ポインタ型の整数型への変換は処理系定義
 
}

....
....

DRV_HANDLE DRV_TMR_Open //タイマドライバー初期化
( 
    const SYS_MODULE_INDEX index, 
    const DRV_IO_INTENT ioIntent 
)
{

    if (index >= DRV_TMR_INSTANCES_NUMBER || ( ioIntent & DRV_IO_INTENT_SHARED ) != 0)
    {   // only exclusive access for now.
        return DRV_HANDLE_INVALID;
    }

    if(gDrvTmrInstances != 0)//タイマ用システムモジュールが初期化されている場合
    {   // module initialized
        DRV_TMR_MODULE_DESCRIPTOR* pDcpt = gDrvTmrDcpt + index;
        if(pDcpt->tmrInstance.inUse != false)
        {   // search a free client
            int ix;

            DRV_TMR_CLIENT_OBJ* dObj = pDcpt->tmrClients + 0;
            for(ix = 0; ix < sizeof(pDcpt->tmrClients) / sizeof(*pDcpt->tmrClients); ix++, dObj++)
            {
                if(dObj->clientStatus == DRV_TMR_CLIENT_OBJ_CLOSED)
                {   // found free client
                    dObj->pModInst = &pDcpt->tmrInstance;
                    dObj->clientStatus = DRV_TMR_CLIENT_OBJ_READY;
                    return ( ( DRV_HANDLE ) dObj );//タイマドライバーの
                                                      //ハンドルを返す

                }
            }
        }
    }

    return DRV_HANDLE_INVALID;
}




bool DRV_TMR_AlarmRegister 
( 
    DRV_HANDLE handle, 
    uint32_t divider, 
    bool isPeriodic,
    uintptr_t context, 
    DRV_TMR_CALLBACK callBack 
)
{
    DRV_TMR_CLIENT_OBJ *dObj = _DRV_TMR_ClientObj(handle);

    if(dObj == 0)
    {
        return false;
    }

    DRV_TMR_OPERATION_MODE operMode = dObj->pModInst->operMode;
    bool success = false;

    if(operMode == DRV_TMR_OPERATION_MODE_32_BIT)
    {
        success = (divider >= DRV_TIMER_DIVIDER_MIN_32BIT && divider <= DRV_TIMER_DIVIDER_MAX_32BIT);
    }
    else
    {
        success = (divider >= DRV_TIMER_DIVIDER_MIN_16BIT && divider <= DRV_TIMER_DIVIDER_MAX_16BIT);
    }

    if(success)
    {
        bool resume = _DRV_TMR_Suspend(dObj);
        _DRV_TMR_ClientSetParams(dObj, divider - 1, isPeriodic, context, callBack);

        if(operMode == DRV_TMR_OPERATION_MODE_32_BIT)
        {
            PLIB_TMR_Period32BitSet ( dObj->pModInst->tmrId, divider - 1);
        }
        else
        {
            PLIB_TMR_Period16BitSet ( dObj->pModInst->tmrId, (uint16_t)divider - 1 );
        }
        if(resume)
        {
            _DRV_TMR_Resume(dObj, resume);
        }
        else
        {
            dObj->clientStatus = DRV_TMR_CLIENT_OBJ_ARMED;
        }
    }


    return success;
}

....
....

static void _DRV_TMR_ClientSetParams(
        DRV_TMR_CLIENT_OBJ* pObj, 
        uint32_t period, 
        bool isPeriodic,                        
        uintptr_t context, 
        DRV_TMR_CALLBACK callBack
)
{
    pObj->alarmCallback = callBack ;
    pObj->alarmPeriodic = isPeriodic;
    pObj->context = context;
    pObj->pModInst->timerPeriod = period;
    pObj->alarmCount = 0;
}

....
....


void DRV_TMR_Tasks ( SYS_MODULE_OBJ object ) //
{
    DRV_TMR_MODULE_DESCRIPTOR* pDcpt = _DRV_TMR_ModuleObj(object, true);

    if(pDcpt)　//ハンドルが妥当な場合
    {
        DRV_TMR_ProcessEvents(pDcpt);
    }

}

....
....

static void DRV_TMR_ProcessEvents ( DRV_TMR_MODULE_DESCRIPTOR* pDcpt ) //
{
....
....
    DRV_TMR_CLIENT_OBJ* pClient = pDcpt->tmrClients;
....
....

     /* callback the application routine */
        if( pClient->alarmCallback != NULL )
        {
           (*pClient->alarmCallback)( pClient->context, pClient->alarmCount); //
                                         //コールバック関数の呼び出し
        }
....
....
} 


bool DRV_TMR_Start ( DRV_HANDLE handle )
{
    DRV_TMR_CLIENT_OBJ *dObj = _DRV_TMR_ClientObj(handle);

    if(dObj && dObj->clientStatus == DRV_TMR_CLIENT_OBJ_ARMED)
    {
        _DRV_TMR_Resume(dObj, true);

        /* Update the Client Status */
        dObj->clientStatus = DRV_TMR_CLIENT_OBJ_RUNNING;
        return true;
    }
    return false;
}

.....
.....

typedef uintptr_t SYS_MODULE_OBJ; //システムモジュールのインスタンスへのハンドル
....
....


typedef struct
{
    SYS_MODULE_OBJ  sysDevcon; //システムのハンドル
    SYS_MODULE_OBJ  drvTmr0;   //タイマのハンドル

} SYSTEM_OBJECTS;

.....
.....

//ダイナミックタイマの具体的設定値
#define DRV_TMR_INTERRUPT_MODE             true
#define DRV_TMR_INSTANCES_NUMBER           1
#define DRV_TMR_CLIENTS_NUMBER             1

//タイマ１の具体的ハードウェア諸元
#define DRV_TMR_PERIPHERAL_ID_IDX0          TMR_ID_1
#define DRV_TMR_INTERRUPT_SOURCE_IDX0       INT_SOURCE_TIMER_1
#define DRV_TMR_INTERRUPT_VECTOR_IDX0       INT_VECTOR_T1
#define DRV_TMR_ISR_VECTOR_IDX0             _TIMER_1_VECTOR
#define DRV_TMR_INTERRUPT_PRIORITY_IDX0     INT_PRIORITY_LEVEL1
#define DRV_TMR_INTERRUPT_SUB_PRIORITY_IDX0 INT_SUBPRIORITY_LEVEL0
#define DRV_TMR_CLOCK_SOURCE_IDX0           DRV_TMR_CLKSOURCE_INTERNAL
#define DRV_TMR_PRESCALE_IDX0               TMR_PRESCALE_VALUE_256
#define DRV_TMR_OPERATION_MODE_IDX0         DRV_TMR_OPERATION_MODE_16_BIT
#define DRV_TMR_ASYNC_WRITE_ENABLE_IDX0     false
#define DRV_TMR_POWER_STATE_IDX0            SYS_MODULE_POWER_RUN_FULL
....
....

.....
.....
#define DRV_TMR_INDEX_0                        0
#define DRV_TMR_INDEX_1                             1
#define DRV_TMR_INDEX_2                             2
#define DRV_TMR_INDEX_3                             3
#define DRV_TMR_INDEX_4                             4
#define DRV_TMR_INDEX_5                             5
#define DRV_TMR_INDEX_6                             6
#define DRV_TMR_INDEX_7                             7
#define DRV_TMR_INDEX_8                             8       
#define DRV_TMR_INDEX_9                             9

....
....

//ダイナミックタイマの諸元を規定する構造体
typedef struct
{
    /* System module initialization. */
    SYS_MODULE_INIT moduleInit;

    /* Identifies timer hardware module (PLIB-level) ID */
    TMR_MODULE_ID tmrId;

    /* Clock Source select. */
    DRV_TMR_CLK_SOURCES clockSource;

    /* Prescaler Selection from the processor enumeration */
    TMR_PRESCALE prescale;
    
    /* Interrupt Source for TMR module.  If 'DRV_TMR_OPERATION_MODE_32_BIT' flag
       is selected the interrupt will be generated by the 2nd timer of the pair,
       the odd numbered one. */
    INT_SOURCE interruptSource;

    /* Select 16/32 bit operation mode.  32 bit mode will combine two 16 bit
       timer modules to form a 32 bit one.  This is usually only necessary for
       very long delays. */
    DRV_TMR_OPERATION_MODE mode;

    /* Asynchronous write enable configuration.  If true the asynchronous write
       is enabled.  For timers that do not support this feature the value is
       ignored */
    bool asyncWriteEnable;

} DRV_TMR_INIT;
....
....

typedef void ( *DRV_TMR_CALLBACK ) ( uintptr_t context, uint32_t alarmCount );//
  // DRV_TMR_CALLBACKは、voidを返す（戻り値のない）
  //第一引数uintptr_t context、第二引数uint32_t alarmCountの関数へのポインタ
....
....

typedef uintptr_t SYS_MODULE_OBJ;   //システムモジュールインスタンスのハンドル
.....
.....

typedef union
{
    uint8_t         value;

    struct
    {
         uint8_t     powerState  : 4;
/*
    Predefined powerState Values:

    - 0.  SYS_MODULE_POWER_OFF        - Module power-state power off state code
    - 1.  SYS_MODULE_POWER_SLEEP      - Module power-state sleep state code
    - 2.  SYS_MODULE_POWER_IDLE_STOP  - Module power-state idle-stop state code
    - 3.  SYS_MODULE_POWER_IDLE_RUN   - Module power-state idle-run state code
    - 4.  through 14.                 - Module-specific meaning
    - 15. SYS_MODULE_POWER_RUN_FULL   - Module power-state run-full state code
*/

        uint8_t     reserved    : 4;
    }sys;

} SYS_MODULE_INIT;

.....
.....

typedef struct
{
    /* The status of the driver */
    SYS_STATUS                                              status;

    /* Time Period Value */
    uint32_t                                                timerPeriod;

    /* Pre-scaler Selection from the processor enumeration */
    TMR_PRESCALE                                            prescale;

    /* Timer Peripheral Id */
    TMR_MODULE_ID                                           tmrId;

        /* Timer Peripheral Id associated with Timer's 32-bi mode */
    // TMR_MODULE_ID                                            tmrNextId;

    /* Timer clock source */
    DRV_TMR_CLK_SOURCES                                     clockSource;

    /* Interrupt Source for TMR Interrupt */
    INT_SOURCE                                              interruptSource;

    /* TMR Driver HW instance operational flags */
    bool                                                    inUse;

        /* operation mode */
        DRV_TMR_OPERATION_MODE                                  operMode;

    /* Asynchronous write enable, if supported */
    bool                                                    asyncWriteEnable;       

    /* Semaphore to protect 'alarm count' */
    OSAL_SEM_HANDLE_TYPE                                    alarmCountSemaphore;

} DRV_TMR_MODULE_INSTANCE;
....
....

typedef struct
{
    /* Modul einstance this client belongs to */
    DRV_TMR_MODULE_INSTANCE*                    pModInst;

        /* Do the alarm periodically */
        bool                                        alarmPeriodic;
        
    /* Status of the client object */
    DRV_TMR_CLIENT_OBJ_STATUS                   clientStatus;

    /* Client's alarm counter */
    uint32_t                                    alarmCount;

    /* Alarm callback */
    DRV_TMR_CALLBACK                            alarmCallback;
                                         //コールバック関数へのポインタ

    /* Client context */
    uintptr_t                                   context;


} DRV_TMR_CLIENT_OBJ;